home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BUSINESS / ATOQP.ARJ / ATOQP.DOC next >
Text File  |  1992-02-16  |  10KB  |  215 lines
  1.    
  2.  
  3.  
  4.  
  5.  
  6.                     ATOQP.EXE -- ASCII to Quattro Pro
  7.                     =================================
  8.   
  9.  
  10.    What does it do?
  11.    ================
  12.    
  13.    ATOQP is a utility program designed to take a space delimited ASCII file
  14.    and translate it into a Quattro Pro (.WQ1) file.  The major purpose of
  15.    ATOQP is to get around the limitation of having less than 255 characters
  16.    on a line when you do an ASCII import in Quattro Pro.  ATOQP reads
  17.    your text file and determines what type of entry your data would be
  18.    (label or value), thus eliminating the need for parsing your file.
  19.    
  20.    There is no need for special delimiters.  ATOQP determines where one
  21.    cell ends and another begins when it encounters spaces.  The number of
  22.    spaces does not matter, so you can bring in all of those space padded
  23.    text files from your word-processor or database programs.
  24.  
  25.    If you receive a text file that has tabs or other delimiters, you must
  26.    remove them before using this program.  Any word processor with a 
  27.    search and replace command will do the trick.
  28.    
  29.    How do you use it?
  30.    ==================
  31.    
  32.    To use ATOQP, simply copy the executable program to your hard-disk.
  33.    I recommend that you put it in a temporary directory with your text
  34.    file(s).  Once you are in the directory with your files, simply type:
  35.    
  36.        ATOQP <text file> <spreadsheet.wq1> [CR]
  37.    
  38.    In English, this would be:
  39.    
  40.        ATOQP data.txt budget.wq1
  41.    
  42.    if you wanted to translate the data.txt file into a spreadsheet named
  43.    budget.wq1.  The [CR] means to press the enter key.  If you happen to
  44.    forget what the format is, simply type ATOQP with no arguments.
  45.    
  46.    It is necessary to place the .WQ1 extension onto the file.  If you
  47.    forget, however, then you must rename the file so that it has a .WQ1 
  48.    extension before trying to open it in Quattro Pro.  You can do this at 
  49.    any local DOS prompt with the RENAME command.
  50.  
  51.    What does it all mean?
  52.    ======================
  53.    
  54.    ATOQP will tell you what it is doing (or not doing) while it is
  55.    running.  There are two methods that ATOQP can process your file:
  56.    memory intensive and disk intensive.  The size and structure of the
  57.    file, as well as the amount of available RAM (conventional) determine
  58.    how the program operates.  Barring any error messages, you will see
  59.    one of the following sets of messages:
  60.    
  61.    RAM intensive messages      Disk intensive messages
  62.    =======================      ============================
  63.    
  64.    Analyzing the input file...      Analyzing the input file...
  65.    Parsing data file...          Insufficient memory to process file.
  66.    Cleaning up .tmp files...      Switching to disk-access mode
  67.                                   This could take some time.
  68.                   Parsing data file...
  69.                   Cleaning up .tmp files...
  70.    
  71.    Here is what each message indicates:
  72.    
  73.    Analyzing the input file...
  74.         
  75.         ATOQP is examining your incoming text file to determine its
  76.         structure.  Depending on the amount of information in the
  77.         text file, as well as how the information breaks down in terms
  78.         of rows and columns, ATOQP will decide upon a course of
  79.         action in translating your text file.
  80.    
  81.    Parsing data file...
  82.    
  83.         ATOQP is examining each entry in your file and determining its
  84.         spreadsheet equivalent.  For example, the entry 123 would be
  85.         brought in as a value, while 123-456 would be brought in as
  86.         a label.  If ATOQP cannot figure out what the entry is, it
  87.         will bring it into Quattro Pro as a label and let you
  88.         decide.
  89.         
  90.    Insufficient memory to process file
  91.    Switching to disk-access mode
  92.    This could take some time.
  93.    
  94.         If memory does not permit (perhaps the file is too large, or
  95.         its structure makes it impossible to allocate enough RAM),
  96.         then ATOQP will do the job via disk access.  This process 
  97.         is very disk intensive and slow, but it gets the job done. 
  98.  
  99.                               *** WARNING ***
  100.         If you think you have problems with your hard drive, run the DOS
  101.         program CHKDSK or some other utility (e.g., Norton Utilities).
  102.         Bad sectors on the disk or excessive amounts of lost chains and
  103.         clusters is not good.  Combining the above problems with any disk
  104.         intensive operations is asking for trouble.
  105.    
  106.    Cleaning up .tmp files...
  107.    
  108.         ATOQP creates a series of temporary work files.  Since it would
  109.         be rude to leave these on your drive, ATOQP clears them out.
  110.    
  111.    After the job is done, ATOQP will give you a report.  It will tell you
  112.    how many rows and columns of data were parsed, how long the operation
  113.    took, and the average number of records processed per second.
  114.  
  115.    If you wish to terminate the program at any time (for example, if the
  116.    the program is reading and writing to disk and you want to stop and
  117.    do other work), you can press Ctrl-C (Ctrl-Break on some machines).
  118.    In technical terms, you are making an "ungraceful exit" from the program.
  119.    Becuase the program was not allowed to finish, there will be some files
  120.    you will want to remove.  You will notice them very quickly, as they all
  121.    have the extension .TMP with a number in front of it (i.e., 1.TMP, 2.TMP,
  122.    etc.).  You must remove these files before running the program again.
  123.    
  124.    Error Messages:
  125.    ===============
  126.    
  127.    No program is complete without error messages.  For the most part, the
  128.    only message(s) that you are likely to run into will occur while ATOQP is
  129.    analyzing your file.  If you try to run this program and do not have
  130.    enough free space on your drive, ATOQP will tell you about it.  It
  131.    will also inform you of how much free space you need to clear up for
  132.    the program to run.
  133.    
  134.    If you get any messages that end with the words "Program Terminated"
  135.    and an unceremonious dump back to your DOS prompt, please get in
  136.    contact with the author.  This type of information will help to refine
  137.    the program.  I have done my best to limit chances of errors.
  138.    
  139.    Known Program Limitations:
  140.    ==========================
  141.    
  142.    ATOQP is a specific tool for a specific job.  If you have small files
  143.    that are already delimited (i.e., quote and comma), then use the
  144.    import features of Quattro Pro.  ATOQP was written to get around a
  145.    limitation of Quattro Pro and its ASCII import function.  It is not
  146.    meant to be a replacement for Quattro Pro's import tools, just a
  147.    supplement.
  148.  
  149.    ATOQP is expecting a 'rectangular' file.  This means that you have the
  150.    same amount of cell information in each row (i.e., each row has the
  151.    same number of space delimited entries).  The program will not fail if
  152.    you do not meet this requirement, but you will not get the spreadsheet
  153.    you expect when it is finished.  The concept of a rectangular file
  154.    should not cause too many problems, as this is the form of most text
  155.    files that would be downloaded from other applications (i.e.,
  156.    mainframe databases).
  157.    
  158.    ATOQP does not use any delimiters (other than space).  If you need
  159.    to have a space in a cell entry (e.g., Joe User in one cell), replace the
  160.    space with an underscore character (e.g., Joe_User).  You can remove
  161.    the underscore with Quattro Pro's /Edit | Search & Replace command.
  162.    
  163.    ATOQP will warn you if you try to bring in a file that is too large to
  164.    fit into a spreadsheet.  It will then go on and process as much of
  165.    your file as possible.   Most people will not run into this problem,
  166.    since a spreadsheet in Quattro Pro has 2,097,152 cells.  If your file is
  167.    this large, you might want to seriously consider a database application.
  168.    
  169.    ATOQP may go into disk-access mode on what you may consider to be a
  170.    small file.  File structure plays a large role in determining the
  171.    approach the program takes -- larger than the actual size of the file on
  172.    disk.  Just like Quattro Pro, the more columns of data there are, the
  173.    more memory is needed.  If you have a large number of entries on a
  174.    line, it could force the program into the disk mode even if there are
  175.    only a few rows.
  176.    
  177.    Other information:
  178.    ==================
  179.    
  180.    This program is shareware.  Use it, share it with your friends.  If
  181.    you use this program, and you like what it does, support future
  182.    versions and other shareware utilities by sending $10.00 to:
  183.    
  184.        Rich Wilkman
  185.        41 Grandview Street #1405
  186.        Santa Cruz, CA  95060
  187.    
  188.    If you have questions, comments, problems to report, or just want to
  189.    practice your electronic mail skills, I can also be reached via
  190.    Compuserve.  Send CIS mail to:  70412,1340.  Feel free to send 
  191.    compliments (even programmers need to be told their work is liked),
  192.    or suggestions for features that you would like to see.  
  193.    
  194.    Obligatory Disclaimers:
  195.    =======================
  196.    
  197.    Borland International is *NOT* responsible for this program in any way.
  198.    If you have any questions about its operation, or problems with the
  199.    program itself, please do not contact Borland.  Use one of the methods
  200.    listed above to make contact with the author of the program.
  201.  
  202.    This program was developed with Borland C++ versions 2.0 and 3.0, and
  203.    the resulting files were tested in Quattro Pro 3.0.  Since the spread-
  204.    sheets created by this program contain only the most basic file infor-
  205.    mation, you can use this program to create files for versions 1 and 2
  206.    of Quattro Pro.
  207.    
  208.    I have tested this program to the best of my abilities, but no program
  209.    is perfect.  If anything out of the ordinary happens while running
  210.    this program, please contact the author.  I cannot be responsible for
  211.    any data lost while using this program, and I cannot stress enough the
  212.    need for backups of your data.  The only testament of faith I can
  213.    give is that I developed and tested this program on my personal
  214.    machine with no loss of data (not even a byte).
  215.